Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

File Mode Flags

QuickDraw 3D defines a set of file mode flags to specify a file object's current file mode. The file mode is returned to you when you call Q3File_OpenRead , Q3Open_Write , or Q3File_GetMode .

typedef enum TQ3FileModeMasks {
    kQ3FileModeNormal                       = 0,
    kQ3FileModeStream                       = 1 << 0,
    kQ3FileModeDatabase                     = 1 << 1,
    kQ3FileModeText                         = 1 << 2
} TQ3FileModeMasks;

Constant descriptions

kQ3FileModeNormal
Set if the file object is organized in normal mode. A file object is in normal mode if it contains a table of contents that lists all referenced objects in the file object. Normal mode is the most compact metafile representation.
kQ3FileModeStream
Set if the file object is organized in stream mode. A file is in stream mode if there are no internal references in the file. You can use stream mode for reading or writing unidirectional streams, but a file in stream mode is usually larger than a file in normal mode.
kQ3FileModeDatabase
Set if the file object is organized in database mode. A file object is in database mode if the file object lists in its table of contents all shared objects contained in the file object, whether or not those objects are multiply referenced.
kQ3FileModeText
Set if the file object is a text file. The file object is read as text, using tokens and behaviors appropriate for text file objects.

You can combine the kQ3FileModeText mask with any of the other masks, and you can combine the kQ3FileModeStream and kQ3FileModeDatabase masks in a single file mode.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |